home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 202 / applic / tiny33.doc < prev    next >
Text File  |  1987-12-17  |  12KB  |  308 lines
  1. TINYSTUFF 3.3 and TINYVIEW 4 by David Mumper 
  2. Copyright (c) 1987 by David Mumper 
  3.    
  4. Nov 3, 1987 
  5.  
  6. This version of TinyStuff is for the personal use of donators ONLY. 
  7. Please do not distribute it in any form.  The TinyDemo and the 
  8. TinyViewer are public domain. 
  9.  
  10. Organization 
  11. ------------ 
  12.  
  13. The new version of TinyStuff is organized into 3 major menu types, with 
  14. the requisite 'about' option in the Desk menu.  The three menus are used 
  15. to select any options, choose the Source format of the pictures, and 
  16. choose the destination format of the pictures respectively.  Currently 
  17. there are 9 Source, and 6 Destination formats available. 
  18.  
  19. Menus 
  20. ----- 
  21.  
  22. The following are the descriptions and special information pertaining to 
  23. each of the menu options. 
  24.  
  25. Desk:About Tiny... 
  26. ------------------ 
  27.  
  28. The About Tiny menu option is a way for me to get a little ad in :-).  In 
  29. addition to this, it also show the user the amount of memory available 
  30. for use in the picture conversion process.  This amount is approximately 
  31. 1/2 the total system available memory, and is the maximum amount usable 
  32. by a source file.  (i.e. a PC Paintbrush picture can be many Meg in 
  33. size.  Therefore, the compressed version of the picture can be no larger 
  34. than the amount shown in the box, and the decompressed version can not 
  35. be larger than double that.) 
  36.  
  37. Options:Compressed 
  38. ------------------ 
  39.  
  40. Compressed is one of the 'under construction' options in the menus.  It 
  41. is intended to be a compress function just like that in Picswitch. 
  42.  
  43. Options:Convert Res... 
  44. ---------------------- 
  45.  
  46. The Convert Res option is to allow you to convert pictures from one 
  47. resolution to another.  You may convert Low to Mono, Medium to Low or 
  48. Mono, and Mono to Medium or Low. 
  49.  
  50. The conversions to Monochrome use a dithering technique which comes in 
  51. two types.  The first type is just taking the absolute luminence of each 
  52. color and produce a dither pattern dependant on how right it is in 
  53. reference to total black and total white.  The second type changes the 
  54. reference points for the dither to the darkest and lightest colors on 
  55. the picture, which would give you the maximum amount of contrast.  The 
  56. first type takes about 10 seconds and the second around 18 seconds. 
  57.  
  58. When converting to Mono, you will be asked which of the 2 types you 
  59. desire.  In most cases the quicker version (FULL) will work identically 
  60. to the slower (PARTIAL).  This is because most pictures actually use 
  61. both Black and White, the only pictures that will improve are those that 
  62. don't use both.  You can select the type for all Low res and all Medium 
  63. res conversions seperately. 
  64.  
  65. Options:Display Pic 
  66. ------------------- 
  67.  
  68. The Display Pic option causes the program to display the pictures on the 
  69. screen as they are converted.  This option is over-ridden in some 
  70. picture types.  (i.e.  The MacPaint load will display the pictures 
  71. regardless of the setting because you have to choose the portion of the 
  72. picture you want.)  All pictures will be displayed on the color monitor 
  73. if this option is ON.  This option defaults to ON on the color monitor 
  74. and OFF on the monochrome monitor. 
  75.  
  76. Options:Display Name 
  77. -------------------- 
  78.  
  79. The Display Name option causes the program to display the pictures name 
  80. in a dialog box on the screen as the picture is converted.  The name 
  81. will be displayed for both the source and destination file.  The path is 
  82. not included.  This option and the Display Pic option may both be used 
  83. at the same time. 
  84.  
  85. Options:Delete Original 
  86. ----------------------- 
  87.  
  88. This option allows you to convert pictures on disks with minimal free 
  89. space.  It will delete the original ONLY after the destination file is 
  90. successfully written.  It will also delete the original even if it is 
  91. Locked, although it won't delete it if the source disk is write 
  92. protected. 
  93.  
  94. Options:Convert All 
  95. ------------------- 
  96.  
  97. The Convert All option will convert all pictures of the Source Format 
  98. into pictures of the Destination format using the Paths last specified. 
  99. When the program is first executed, the default path for both the Source 
  100. and Destination files is the same as that which the program was run 
  101. from.  If you have used the Convert Some option since executing the 
  102. program, the paths you chose then will be used for Source and 
  103. Destination, though the filename will be *.typ, where typ is the proper 
  104. extender for the source type. 
  105.  
  106. Options:Convert Some 
  107. -------------------- 
  108.  
  109. The Convert Some option lets you specify specific files, and/or 
  110. drive/path changes for the Source and Destination pictures.  The program 
  111. will bring up an File Selector box for the Source pictures.  At this 
  112. point you can change the path and drive just like normal, and enter in 
  113. the filename to use for conversion.  The filename can contain wildcard 
  114. characters (* for multiple characters, and ? for single characters, just 
  115. like normal) in both filename and extension.  You must supply some type 
  116. of Filename.  After you have selected the files to convert, press 
  117. RETURN, or use the OK button.  If you have changed your mind, you can 
  118. now select the CANCEL button. 
  119.  
  120. After entering the Source information, you will be presented with a File 
  121. Selector Box for the Destination information.  The Path is the only 
  122. thing that really matters here, you need not enter anything in for a 
  123. filename.  Use the OK button, or the RETURN key to begin the conversion 
  124. process, or use the CANCEL button to abort. 
  125.  
  126. Convert:Quit 
  127. ------------ 
  128.  
  129. This option will exit the program and place you back at the GEM desktop. 
  130.  
  131. Source:Tinyview 
  132. --------------- 
  133.  
  134. This option converts loads all Tiny files.  It expects an extender of 
  135. .TN?, where the ? is any valid character (Normally it is Y, 1, 2, 3, 4, 
  136. or 5.) 
  137.  
  138. Source:Degas Normal 
  139. ------------------- 
  140.  
  141. This option will load any Normal D.E.G.A.S. picture.  This includes the 
  142. 32034, and 32066 length files written by either D.E.G.A.S. or D.E.G.A.S. 
  143. Elite or any of the other programs that write files usable in either of 
  144. these programs.  
  145.  
  146. Source:Degas Compressed 
  147. ----------------------- 
  148.  
  149. This option will load any compressed D.E.G.A.S. picture.  This includes 
  150. the pictures written by D.E.G.A.S. Elite and the Computer Eyes Software 
  151. (Naughty boy JAKOB, you cheat!)  Pictures are variable in size but 
  152. shouldn't be smaller than 866 bytes. 
  153.  
  154. Source:Neochrome 
  155. ---------------- 
  156.  
  157. This option will load any Neochrome compatible pictures.  This includes 
  158. Medium res and Monochrome pictures (that NEO will not load.)  Again, it 
  159. will handle most pictures created by Public domain conversion programs. 
  160. Files should be 32128 bytes in size or larger. 
  161.  
  162. Source:Doodle 
  163. ------------- 
  164.  
  165. This loads 32000 bytes data files created by programs such as Doodle. 
  166. These files are just screen data, without the color or resolution 
  167. information.  The picture is displayed in the current resolution using 
  168. the current color palette. 
  169.  
  170. Source:IFF 
  171. ---------- 
  172.  
  173. This option is 'under construction', though I doubt I will implement it 
  174. due to the Excelent conversions that Bruce Holloway's program does. 
  175.  
  176. Source:MacPaint 
  177. --------------- 
  178.  
  179. This option allows you to load Macintosh MacPaint pictures.  When you've 
  180. loaded the picture, you will be able to scroll the picture around on the 
  181. screen so you can select the portion of the picture to use.  When you 
  182. are satisfied with the picture, press the left mouse button to fix it in 
  183. place and save it.  MacPaint pictures are always interpreted as 
  184. Monochrome. 
  185.  
  186. Source:Mac Startup 
  187. ------------------ 
  188.  
  189. This option allows you to load Macintosh Startup screens.  Again these 
  190. pictures are always interpreted as Monochrome. 
  191.  
  192. Source:PC Paintbrush 
  193. -------------------- 
  194.  
  195. This option allows you to load pictures from PC Paintbrush (an IBM 
  196. program) pictures.  This format is also used by some Image Scanners on 
  197. the IBM PC's.  Because these pictures can be in excess of 8 Megabytes in 
  198. size, not all of them will load on a standard ST :-).  I have used this 
  199. on Monochrome pictures, but cannot guarantee that it works for all 
  200. formats (EGA, CGA, etc.) because I could only get a couple of pictures. 
  201.  
  202. In order to facilitate usage of these large files, you are able to 
  203. scroll over the entire screen.  If you wish, you can use the right mouse 
  204. button to perform a 50% compression (both Horizontal and Vertical) on 
  205. monochrome pictures.  Again, as in the MacPaint option, the left mouse 
  206. button will save the picture. 
  207.  
  208. Source:All 
  209. ---------- 
  210.  
  211. This is an option that allows you to mix any of the other 8 formats on 
  212. one disk, and convert all of the pictures at once.  Any picture that is 
  213. already in the Destination format is ignored.  
  214.  
  215. Dest:Tinyview 
  216. ------------- 
  217.  
  218. This writes Tinyview format files.  The file extender is set to .TN? 
  219. where the '?' is 1, 2, or 3 depending on the resolution (Low, Med, or 
  220. Mono) and has a 3 added to it if the picture is rotating.  (Note: As of 
  221. today, I have 3747 pictures and Tiny is running an average compression 
  222. of 56% savings or an average file size of 14,111.308 bytes.) 
  223.  
  224. Dest:Degas Normal 
  225. ----------------- 
  226.  
  227. This writes D.E.G.A.S. uncompressed files.  This is in the D.E.G.A.S. 
  228. Elite format which includes rotation information for the first set of 
  229. cycling colors only. 
  230.  
  231. Dest:Degas Compressed 
  232. --------------------- 
  233.  
  234. This option is 'Under Construction' until such time as I adjust Tiny to 
  235. handle the 4 rotation setup. 
  236.  
  237. Dest:Neochrome 
  238. -------------- 
  239.  
  240. This option will write a Neochrome format file.  It ignores the 
  241. resolution restriction of Neo, so it will write Medium and Monochrome 
  242. pictures to this format. 
  243.  
  244. Dest:Doodle 
  245. ----------- 
  246.  
  247. This option will write out only the Picture image information, the color 
  248. palette and the resolution information is dropped. 
  249.  
  250. Dest:Nvision 
  251. ------------ 
  252.  
  253. This option is 'Under Construction' and is intended as a way to save 
  254. double height MacPaint pictures into the Page format of Nvision. 
  255.  
  256. Dest:IFF 
  257. -------- 
  258.  
  259. This option is 'Under Construction' 
  260.  
  261. Dest:MacPaint 
  262. ------------- 
  263.  
  264. This option will write out a picture usable by MacPaint.  It should only 
  265. be used on Monochrome pictures, and will allow you to move margin bars 
  266. to determine which parts will be truncated from the left and right sides 
  267. of the screen.  This will create a half-height picture for use in 
  268. MacPaint. 
  269.  
  270. Dest:PC Paintbrush 
  271. ------------------ 
  272.  
  273. This allows you to write pictures in PC Paintbrush format usable by PC 
  274. Paintbrush on the IBM PC.  The pictures color information is lost due 
  275. the the color restrictions on the IBM PC. 
  276.  
  277. What's going on 
  278. --------------- 
  279.  
  280. As the picture is being converted, watch the mouse cursor.  It will 
  281. change to a different icon to represent what the program is doing.  You 
  282. will see icons for File Access, Decompression, Compression, Bit Plane 
  283. Mixing, Histogram production, and Dithering. 
  284.  
  285. In the TinyDemo, all the output options are disabled, but the menu 
  286. remains unchanged so you can see which ones are available on the actual 
  287. version of TinyStuff.  In addition, when the end of the directory is 
  288. reached, the program will cycle back to the beginning.  Thus it's 
  289. actually a picture display program for any and all of the source 
  290. formats.  
  291.  
  292. If you have any questions, comments, suggestions, or complaints, you can 
  293. get in touch with me in any of the following ways: 
  294.  
  295. uwvax!uwmcsd1!lakesys!david  On Usenet 
  296. D.MUMPER                     On GEnie 
  297. N68 W25626 Silver Spring Dr  In Real Life 
  298. Sussex, WI  53089 
  299. 414-246-6786                 Voice Phone 
  300. 414-781-5710                 Mil*Atari BBS (1200/300 Baud 24 hour Stadel) 
  301.  
  302. D.E.G.A.S. and D.E.G.A.S. Elite are products of Electronic Arts 
  303. Computer Eyes is a product of Digital Vision 
  304. Neochrome is a product of Atari Inc 
  305. Macintosh and MacPaint are products of Apple Computers 
  306. PC Paintbrush is a product of Zsoft Corp (Microsoft marketed) 
  307. IBM PC is a product of International Business Machines 
  308.